home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 45 / Amiga Format CD45 (1999-09)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-11].iso / +system+ / tools / disk_tools / arestaure203 / arestaure.english < prev    next >
Text File  |  1998-09-07  |  10KB  |  302 lines
  1.  
  2.      //                 ARestaure v2.03 - Documentation            //
  3.    \X/                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~          \X/
  4.  
  5.     
  6.     This  manual  describes the  version 2.03 of  ARestaure.  This
  7. tools is ©1992  by  Jehan-Yves  PROUX,  the  commercial use is STRICLY
  8. FORBIDDEN without author written agreement.
  9.  
  10.     This program can  be  freely distributed, you can spread it in
  11. the way you want,  but  the  program  MUST  be  distributed  WITH  its
  12. documentation  in all  languages  (for  instance  French,  German  and
  13. English) without ANY modification.
  14.  
  15.     I made a lot of tests, but I declines any responsability about
  16. the use of ARestaure. YOU ARE USING  THIS TOOLS AT YOUR OWN RISK.  The
  17. author is not responsible of any  damage, as result of  the use of his
  18. program.
  19.  
  20.     This  program is ShareWare.  It means that  if  you  like  it,
  21. you're invited to send  a donation of 50FF at the address shown at the
  22. end of  this file. You will become a registrated user, and I will send
  23. you a registrated version. You can pay by these ways:
  24.     - cheque of a european bank (for french francs),
  25.     - ready cash (european money or dollar).
  26.  
  27.  
  28.  
  29. Contents
  30. ~~~~~~~~
  31.  
  32.     1. Introduction
  33.     2. How does it works?
  34.     3. Usage
  35.        3.1 Restoration Mode
  36.        3.2 Cleaning Mode
  37.     4. Languages supported
  38.     5. Additional Notes
  39.     6. Thanks
  40.     7. Historic
  41.     8. Conclusion
  42.  
  43.  
  44.  
  45. 1. Introduction
  46. ~~~~~~~~~~~~~~~
  47.  
  48.     Have  you  ever  delete  accidentally a file  or see  after  a
  49. "delete #?" that you were not in the rigth directory ?
  50.  
  51.     Yes? I  too... It's why I have written this utility ARestaure,
  52. which as it name says (with french spelling), permits  you to  restore
  53. files that you have destroyed...
  54.  
  55.  
  56. 2. How does it works?
  57. ~~~~~~~~~~~~~~~~~~~~~
  58.  
  59.     When you delete a file two main actions occurs on your current
  60. volume:
  61.         - your file is disconnected from the directory tree of
  62.             your volume.
  63.  
  64.         - sectors that  your file  owned, are declared free in
  65.             the  BitMap  block(s)  of your  volume.  These
  66.             sectors are never zeroed during this operation
  67.             : the datas are still on your disk.
  68.  
  69.     ARestaure  will  scan your volume, searching for deleted files
  70. and permit you to undelete them.
  71.  
  72.  
  73. 3. Usage
  74. ~~~~~~~~
  75.  
  76.     To start ARestaure, click on its icon on the Workbench or type
  77. "ARestaure" under the Shell.
  78.  
  79.     ARestaure will start to search in your system all the  volumes
  80. that it can manage,  and it will  show you only these  ones  : Also if
  81. you have  a Mac, Unix, Atari, C=64, Sinclair QL,  Apple-II, or why not
  82. an MS-DOS partition, you won't see it on your screen.
  83.     In fact, ARestaure know only how to manage Amiga partitions or
  84. volumes: OFS (the Old Filing System) and FFS (the Fast Filing System),
  85. and the 4 new of OS3.0 (international FS and DCFS) that it means about
  86. 98% of disks connected with our well-known machine.
  87.  
  88.     You  will notice  that ARestaure cannot restore a file deleted
  89. on RAM:, this volume  is purely memory, and space used by your file is
  90. freed when your file  is deleted, it's why RAM: is not  shown on  your
  91. screen. But ARestaure can restore files lost in RAD:.
  92.  
  93.     You have on your screen the following buttons:
  94.  
  95.     DF0: .. DF3:    one button per drive connected (empty or not)
  96.     DH0: .. DHx:
  97.     ..    ..
  98.     ..    ..
  99.     ..    ..
  100.     ..    ..    and as many buttons as you have drives
  101.  
  102.     Français
  103.     Deutsch        to change the current language
  104.     English
  105.  
  106.     SaveCfg        to save the chosen language (only when WB<2.1)
  107.  
  108.     Quit        to quit ARestaure.
  109.  
  110.  
  111.     3.1 Restoration Mode
  112.     ~~~~~~~~~~~~~~~~~~~~
  113.  
  114.         It is the default mode of ARestaure, you can see it by
  115.     viewing the "Mode" Menu.
  116.         In  this  mode,  if you  select a drive,  the  program
  117.     will begin the search immediatly on this drive. A flashing LED
  118.     on  the drive  button indicates  that the program continue  to
  119.     search.
  120.  
  121.         If ARestaure  cannot find any  files, it  will  signal
  122.     it to you in the message box;  if it can,  it will open a file
  123.     requester where you can select the files you want to restaure,
  124.     then  type  <Cancel> or <Restore>.   After that  you  will  be
  125.     back in the starting menu to select another drive or to quit.
  126.  
  127.         Where to find your files? It is impossible to  restore
  128.     your  files  in  the  places  they  were before  the  deletion
  129.     because it is impossible to find where they were linked in the
  130.     directory tree of your volume.  Also I had decided to  restore
  131.     them in T:, the temporary directory of  the Amiga. Usually, T:
  132.     is assigned  to RAM: (see  your Startup-Sequence).  After  the
  133.     restoration, you only have to move the restored files from  T:
  134.     to where you want.
  135.  
  136.         NOTA:    You should have to  enough room in  T: for the
  137.     files you want to restore.
  138.  
  139.         NOTA:    If  several  files  with  the same name are to
  140.     restore, ARestaure will add a count at the end of the filename
  141.     (like ".03").
  142.  
  143.  
  144.     3.2 Cleaning Mode
  145.     ~~~~~~~~~~~~~~~~~
  146.  
  147.         After some  uses of ARestaure in Restoration Mode, you
  148.     will see that ARestaure shows you  a lot of files which aren't
  149.     interessant for you. The goal of  the Cleaning is to zero  all
  150.     free sectors, this forbid  to see  the files destroyed  before
  151.     this operation. This Cleaning has two advantages:
  152.         - You will see only  files removed  after the cleaning
  153.             operation.
  154.         - If you give a disk to someone, you  are sure to give
  155.             only the files you want (and not removed files
  156.             that the person can restore using ARestaure).
  157.  
  158.         To  use  this  mode,  select "Cleaning"  in the "Mode"
  159.     menu. Then select  the  drive you  want. After  a confirmation
  160.     requester, the work begins.
  161.  
  162.         NOTA:    The  drive  must  be   not  protected  against
  163.     writing !
  164.  
  165.  
  166. 4. Languages Supported
  167. ~~~~~~~~~~~~~~~~~~~~~~
  168.  
  169.     ARestaure is  now  almost  ready for the  Amiga Workbench 2.1,
  170. which will support up to  8 languages (according to C=Amiga austria in
  171. Amiga Magazin [german magazine] on 9/92): ARestaure supports the three
  172. languages  I  understand:  French  (my  native  langage),  german  and
  173. english.
  174.  
  175.  
  176.     You  can select the language you want on the main screen. But,
  177. it's impossible to change the current language, when you have the file
  178. requester opened  :  I  didn't  want to manage this, I suppose in fact
  179. that  a normal user  needn't  to change  the current language  all the
  180. time.
  181.  
  182.  
  183.     To  finish with languages, if you  want to  get  a translation
  184. for  the docs  of your software  (that  YOU  have  created  for Public
  185. Domain only), from german or english to french, please write to me.
  186.  
  187.     P.S:    I'm searching  for someone who can correct  my  german
  188. docs, which certainly contains some mistakes.
  189.     
  190.  
  191. 5. Additional Notes
  192. ~~~~~~~~~~~~~~~~~~~
  193.  
  194.     If  you  look at  the  percentage  of  scanned  disk  (between
  195. Languages buttons and the  SaveCfg  button),  you  will see  that  the
  196. scanning  speed varies:  this is  due to the  fact that ARestaure only
  197. read  (or  write)  free  sectors.  So  it  will scan faster  allocated
  198. sectors.
  199.  
  200.     You  can  stop the search for deleted files or the cleaning by
  201. pressing the <Esc> key.
  202.  
  203.  
  204. 6. Thanks
  205. ~~~~~~~~~
  206.  
  207.     I want to thanks here the following persons and firms:
  208.  
  209.     - Muriel PROUX,  my wife for her patience and help in building
  210.         my user interface.
  211.  
  212.     - Denis GOUNELLE, for his ideas and tests of béta-versions, he
  213.         makes on his machine.
  214.  
  215.     - Henric GOMES, who made me discover the wonderfull Amiga.
  216.  
  217.     - Commodore-Amiga for the machine... What a pity that C= sells
  218.         MS-DOS machines too...
  219.  
  220.     -   Free   Software  Fundation   for   the   best   editor   I
  221.         know: GNUEmacs, I used GNUEmacs on Unix machine during
  222.         my job and on the Amiga.
  223.  
  224.  
  225.     - David GAY  (Switzerland)  for  his GNUEmacs'  Amiga  port, a
  226.         very good job, David ! Continue to work for the Amiga.
  227.  
  228.     - Carsten  Lergenmüller, Arthur  Isaak,  Bernd Hofmann,  Bernd
  229.         Neudecker,  Dehnick  Wolf-Peter, and Tim  Rühsen  (the
  230.         germans) and  Max Roemer, who  help me to write  a  so
  231.         perfect (!) german documentation.
  232.  
  233.  
  234. 7. Historic
  235. ~~~~~~~~~~~
  236.  
  237.     v1.00    13-Oct-92
  238.         o First spread version.
  239.  
  240.     v1.XX    11-Nov-92
  241.         o Preversion  of the  v2.00, restricted  spreading for
  242.           validation.
  243.         o Cleaning Mode added
  244.         o some I/O are better tested
  245.         o evolution of percentage is smoother
  246.         o in  restoration mode, if several file have  the same
  247.           name, ".XX" is added at the end of the filenames.
  248.  
  249.     v2.00    28-Nov-92
  250.         o Date of files are added in FileRequester of  deleted
  251.           files.
  252.         o GadgetBorder are changed.
  253.  
  254.     v2.01    06-Dec-92
  255.         o Now  I  use  RemoveGList() during the  search or the
  256.           cleaning, this permit me to  forbid user to  disturb
  257.           the display.
  258.         o The  user  must now use the Esc key (and no more the
  259.           SELECT mouse key) to  stop the searching or cleaning
  260.           operation,  this  avoid  to  stop   accidentally  an
  261.           operation on a 60Mb harddisk.
  262.  
  263.     v2.02    21-Feb-93
  264.         o Correction  due to  a  bug done  by  C=  [  :-) ]
  265.           (DosEnvec->de_DosType = 'DOS\0' (on Kickstart  2.04,
  266.           WB  2.1), even if the floppy disk was  formatted  as
  267.           FFS !). To correct this problem, now I read the boot
  268.           sector of all floppy disks declared OFS in DosEnvec,
  269.           to know if it's really an OFS !
  270.         o All  writes on results files t:xx  weren't verified,
  271.           now they are.
  272.  
  273.     v2.03    21-May-93
  274.         o Now   works  with  new   OS3.0   filesystems  of  C=
  275.           (international and DCFS).
  276.         o Best work with AA-modes.
  277.         o The gadget "SaveCfg" is  disabled, if ARestaure find
  278.           the language to use with the Locale.library.
  279.         o I added a window,  in order  to  tell the user, that
  280.           ARestaure is  SHAREWARE  (On  21-May-93,  I  have no
  281.           contribution yet !).
  282.  
  283. 8. Conclusion
  284. ~~~~~~~~~~~~~
  285.  
  286.     I'm waiting for your suggestions  and beta-tests (there may be
  287. some   problems,   which   escaped   from  source  inspection  !)  and
  288. donation, if I save you long hours of work.
  289.     You can write  me in french, in german or in english [in order
  290. of  my  preferences,  the  French  language  is  my   motherlanguage].
  291. My address is the following:
  292.  
  293.         Jehan-Yves PROUX
  294.         46bis, Bd Robespierre
  295.         F-78300 Poissy
  296.         FRANCE - EUROPE
  297.  
  298. E-Mail:            jyp@ritd.co.uk
  299.  
  300.  
  301.     C U soon !!
  302.